home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / barg.man < prev    next >
Encoding:
Text File  |  1989-06-29  |  5.6 KB  |  199 lines
  1.  
  2.  
  3.  
  4. BARG                      User Commands                      BARG
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      barg - draw a bar graph in gremlin format
  10.  
  11. SSYYNNOOPPSSIISS
  12.      barg [input_file_name [output_file_name]]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      _B_a_r_g is used to generate bar graphs in gremlin format.  It
  16.      takes up to two arguments.  The first argument is the name
  17.      of the _b_a_r_g input file.  The second argument is the name of
  18.      the gremlin file to store the output of _b_a_r_g into.  If the
  19.      output file is not specified then output goes to standard
  20.      output.  If the input file is also missing then input is
  21.      read from standard input.
  22.  
  23.      A _b_a_r_g input file is an ASCII file containing _b_a_r_g commands
  24.      and data.  Each command is on a separate line.  White space
  25.      can be used to separate the different arguments to each com-
  26.      mand. Lines beginning with a "#" and blank lines are
  27.      ignored.  All command arguments that affect the dimensions
  28.      of the graph are specified in pixels.
  29.  
  30.      Graphs are divided up into sets of bars.  Each set can con-
  31.      tain from 1 to 8 bars and there can be any number of sets.
  32.      The program is fully parameterized such that the bar width,
  33.      inner bar spacing, inner set spacing, graph height and graph
  34.      width can all be specified.  All parameters that are not
  35.      specified, except for the number of sets and the number of
  36.      bars in each set which must be specified, will either
  37.      default to preset values or be calculated.  If the inner set
  38.      spacing is not specified or it is specified as -1, it will
  39.      be calculated from the bar width, inner bar spacing and
  40.      graph width.  Likewise if the inner set spacing is set but
  41.      the bar width is not then it will be calculated from the
  42.      other parameters.
  43.  
  44.      The following is a summary of the _b_a_r_g commands:
  45.  
  46.      _C_o_m_m_a_n_d        _A_r_g_u_m_e_n_t_s
  47.  
  48.      b         <left border width> <right border width>
  49.      d         <data set label>
  50.      h         <graph height>
  51.      k         <left key border> <right key border> <key width> <key height>
  52.      lx        <x-axis label>
  53.      ly        <y-axis label>
  54.      n         <num bar sets> <num bars per set>
  55.      p
  56.      s         <inner bar space> <inner set space>
  57.      t         <graph title>
  58.      w         <graph width>
  59.      y         <# of ticks> <delta> <starting value>
  60.  
  61.  
  62.  
  63. Sprite v1.0                                                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. BARG                      User Commands                      BARG
  71.  
  72.  
  73.  
  74.      W         <bar width>
  75.      1         <bar type> <bar label>
  76.      2         <bar type> <bar label>
  77.      3         <bar type> <bar label>
  78.      4         <bar type> <bar label>
  79.      5         <bar type> <bar label>
  80.      6         <bar type> <bar label>
  81.      7         <bar type> <bar label>
  82.      8         <bar type> <bar label>
  83.  
  84.      The following explains each command in more detail:
  85.  
  86.      b    Define the left and right border in pixels.  The left
  87.           border width is the number of pixels between the y-axis
  88.           and the first bar graph.  The right border width is the
  89.           number of pixels that the x-axis extends past the last
  90.           bar graph.
  91.  
  92.      d    Define a bar graph set.  These commands should be the
  93.           last commands in the input file.  The label is the
  94.           string to draw at the bottom of the bar graph set.  The
  95.           following lines up until a line beginning with an "e"
  96.           is found are taken as floating point y values for bars
  97.           in the bar graph set. The line with the "e" marks the
  98.           end of the bar graph set.  There cannot be more than
  99.           the number of bars per set lines of data between the
  100.           "d" and "e" commands.
  101.  
  102.      h    The graph height in pixels.
  103.  
  104.      k    Bar graph key information.  At the bottom of each graph
  105.           each of the different bar types is drawn along with the
  106.           associated label (see the 1-8 commands below).  The
  107.           left key border specifies the number of pixels between
  108.           the y-axis and the first key.  The right key border is
  109.           the number of pixels between the end of the x-axis and
  110.           the rightmost key.  The key width and height define the
  111.           size of the bar that is drawn that represents the key.
  112.  
  113.      lx   Label to print on the x-axis.
  114.  
  115.      ly   Label to print on the y-axis.
  116.  
  117.      n    Define the number of bar sets and the number of bars in
  118.           each set.  This command must come after the dimensions
  119.           of the graph are defined and before the data sets are
  120.           defined with the "d" command.
  121.  
  122.      p    Print a percent sign after each value on the y-axis.
  123.  
  124.      s    Define the number of pixels between each bar and
  125.           between each set of bars.
  126.  
  127.  
  128.  
  129. Sprite v1.0                                                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. BARG                      User Commands                      BARG
  137.  
  138.  
  139.  
  140.      t    Title the graph.
  141.  
  142.      w    The width of the graph in pixels.
  143.  
  144.      y    Define the range of the y-axis.  The # of ticks is the
  145.           number of pieces to divide the y-axis into, the delta
  146.           is the size of each piece and the starting value is the
  147.           base value for y.
  148.  
  149.      W    The width of each bar.
  150.  
  151.      [1-8]
  152.           Define the type of the ith bar in a set.  The type must
  153.           be between 0 and 7 and corresponds to the 8 gremlin
  154.           filled polygon types.  The label is used to print out
  155.           the bar type key.
  156.  
  157. SSEEEE AALLSSOO
  158.      _g_r_e_m_l_i_n(_1)
  159.  
  160. AAUUTTHHOORR
  161.      Michael N. Nelson
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sprite v1.0                                                     3
  196.  
  197.  
  198.  
  199.